home *** CD-ROM | disk | FTP | other *** search
/ Aminet 7 / Aminet 7 - August 1995.iso / Aminet / misc / math / gpamiga_1_38_3.readme < prev    next >
Encoding:
Text File  |  1995-07-02  |  8.1 KB  |  206 lines
  1. Short:    Linear algebra and number theory. Bin.
  2. Author:   pari@ceremab.u-bordeaux.fr, nisse@lysator.liu.se
  3. Uploader: nisse@lysator.liu.se
  4. Type:     misc/math
  5.  
  6. About PARI             (14 dec 1993)
  7. ----------
  8.  
  9. PARI is the name of a sophisticated and free math package. GP is a
  10. calculator that offers all the features of PARI and some more. PARI
  11. uses *infinite* precision rational numbers and *arbitrary* precision
  12. floating point numbers. 
  13.  
  14. You can use complex numbers, vectors, matrices, polynomials, rational
  15. functions and taylor expansions. PARI also handles integers mod n,
  16. finite fields, algebraic numbers and p-adic numbers. PARI includes
  17. standard numerical methods and the GP calculator also includes
  18. hi-resolution plotting.
  19.  
  20. PARI is written by four professional number theorists, C. Batut, 
  21. D. Bernardi, H. Cohen and M. Olivier. The latter two are Professors of
  22. Mathematics.
  23.  
  24. -------
  25.  
  26. This amiga distribution contains the GP calculator compiled for
  27. different processors, an emacs mode for running GP, partial
  28. documentation, and all the amiga specific files I used to compile GP.
  29. The amiga hi-resolution plotting functions are written by Jerry
  30. Tunnell, who kindly let me use and distribute them.
  31.  
  32. If you want full source and documentation, you will have to get the
  33. source distribution. It *should* be available where you found this
  34. package, as file pari-1.38.3.gz or something similar (*Please* keep
  35. this archive and the source archive together. If you like GP, you will
  36. probably want the documentation too). If you can't find the source
  37. anywhere else, you can try to ftp to megrez.ceremab.u-bordeaux.fr,
  38. directory pub/pari/unix. This is the main PARI site.
  39.  
  40.  
  41. Files
  42. -----
  43.   
  44. amiga/             Amiga specific files and sources.
  45.     makefile.68000     Makefiles for different amiga versions.
  46.     makefile.68020 
  47.     makefile.68881
  48.     mpAmiga.s     Assembler file (gcc syntax) for the 68020 versions.
  49.              Converted from mp.s with the convert68k.el program in
  50.              the elisp directory.    
  51.     plotAmiga.c     Hi-resolution plotting functions, written by J.B. Tunnell.
  52.     version68k.diff  Source diffs to add an Amiga version string.
  53.     versionport.diff
  54.  
  55. bin/
  56.     gp.68000     GP binaries for different processors.
  57.     gp.68020
  58.     gp.68881
  59.  
  60. doc/             This directory does not contain the complete documentation,
  61.     usersch3.tex     only one file that is needed by pari.el
  62.  
  63. elisp/
  64.     convert68k.el     Elisp program to convert a sun3 style 68k assembler file
  65.              (read mp.s) into something that amiga gcc can understand.
  66.     pari.el         An Emacs mode for the GP calculator. Desribed below and
  67.     pari.elc     in the file pari.txt
  68.     pari.menu     Used by pari.el.
  69.     pari.txt     A description of pari-mode
  70.  
  71. examples/
  72.     EXPLAIN         Description of the examples.
  73.     Makefile     Note that you cannot compile the C example
  74.     Makesimple     without the libpari.a library.
  75.     bench.gp
  76.     clareg.gp
  77.     lucas.gp
  78.     mattrans.c
  79.       rho.gp
  80.     squfof.gp
  81.       tutnf.gp
  82.     tutnfout
  83.  
  84.  
  85. Starting PARI
  86. -------------
  87.  
  88. First, you need to install Markus Wild's ixemul.library, if you don't
  89. have it already. Version 39.45 is the most recent non-buggy version I
  90. know of (39.47 seems to be unreliable). This library is available on
  91. Aminet (for example at ftp.luth.se) and is included in the gcc
  92. distribution.
  93.  
  94. GP (file gp.68020 or whichever version you use) takes three command line
  95. options. The most important is '-s STACKSIZE'. This sets the initial
  96. size of the internal PARI stack (not to be confused with the task
  97. stack). The default value is 4 MB which may be more RAM than you have
  98. available. Try 'gp -s 1000000' or 'gp -s 100000' if GP refuses to
  99. start. The other two flags are '-p PRIMELIMIT' and '-b BUFFERSIZE'.
  100. Default values are 500000 and 30000 respectively.
  101.  
  102. Talking about the task stack, I don't know exactly how large it must
  103. be. I use a stack of 100000 bytes, and that seems to be enough. To set
  104. the task stack, use the command 'STACK 100000' command from the shell,
  105. not the -s option to GP.
  106.  
  107. At the pari command prompt (default '?'), \q or CTRL-\ exits GP. You
  108. can type '?' to get some on-line help. Note that running GP inside
  109. emacs gives you better online help.
  110.  
  111. The GP command interface is quite straight forward if you are used to
  112. MATLAB or similar systems. Note that with GP both vectors and matrices
  113. are typed with with square brackets '[' ']', with comma ',' separating
  114. elements on the same row and semicolon ';' separating rows. For
  115. example, a 2-2 matrix is typed '[1,2 ; 3,4]'.
  116.  
  117. The emacs mode.  
  118. --------------- 
  119. To use this on the amiga, you must make sure that you have mounted the
  120. FIFO: device, and that the SHELL environment variable is set to some
  121. unix-style shell. I use the shell distributed with gcc, a port of
  122. pdksh (file name gcc/bin/sh). The shell distributed with GNUemacs
  123. might work too, but I haven't tried it. The emacs mode is described in
  124. the file elisp/pari.txt. If you don't wan't to edit the pari.el file,
  125. you should assign PARI: to the directory where you have installed
  126. PARI.
  127.  
  128. Known bugs
  129. ----------
  130. GP does not respond to CTRL-C when run from the shell. However, if you
  131. send the CTRL-C signal from another shell window (with the BREAK
  132. command) or type CTRL-C in GP's emacs buffer, GP is interrupted.
  133.  
  134. A free() call occasionally failes when using the 68000 or 68020
  135. versions of GP. I have not had this problem with the 68881 version.
  136.  
  137. I'm tempted to blame both these problems on the ixemul.library, but
  138. I'm not sure what happens.  
  139.  
  140. For those who are curious about the differences between the three
  141. versions gp.68000, gp.68020 and gp.68881: 
  142.  
  143. * The first two are compiled with gcc -msoftfloat instead of gcc
  144. -m68881. If a 68881 processor is present, all three version makes use
  145. of it. The performance difference between the gp.68020 and the 68881
  146. version should be rather small on any machine that can run both. I
  147. included the 68881 because it seemes more reliable.
  148.  
  149. * In the 68020 and 68881 versions, some low level functions are
  150. written in 68020 assembler, while the 68000 version is written
  151. entirely in C and is compiled with gcc -m68000 to make sure that it
  152. contains only 68000 instructions.
  153.  
  154. ------- 
  155. Enjoy GP!
  156.  
  157. Feel free to send me comments and questions (and even bug reports).
  158.     Niels Möller
  159.     Ställdalsvägen 11
  160.     122 43 Enskede
  161.     SWEDEN
  162. email:    nisse@lysator.liu.se
  163.  
  164. For questions and bug reports not specific to the amiga version, you
  165. can also write to the authors:
  166.     pari@ceremab.u-bordeaux.fr
  167.  
  168.  
  169. ============================= Archive contents =============================
  170.  
  171. Original  Packed Ratio    Date     Time    Name
  172. -------- ------- ----- --------- --------  -------------
  173.     3810    1338 64.8% 07-Dec-93 00:42:02 +makefile.68000
  174.     3822    1345 64.8% 08-Dec-93 22:11:46 +makefile.68020
  175.     3820    1345 64.7% 08-Dec-93 11:50:54 +makefile.68881
  176.   252237   41121 83.6% 06-Dec-93 23:43:52 +mpAmiga.s
  177.    18263    4075 77.6% 10-Nov-93 20:54:16 +plotAmiga.c
  178.      357     246 31.0% 08-Dec-93 22:17:18 +version68k.diff
  179.      360     248 31.1% 08-Dec-93 22:17:34 +versionport.diff
  180.   741836  347584 53.1% 08-Dec-93 19:52:18 +gp.68000
  181.   664588  332545 49.9% 10-Dec-93 20:07:46 +gp.68020
  182.   653256  328318 49.7% 06-Dec-93 23:45:06 +gp.68881
  183.   186465   56779 69.5% 25-Nov-93 17:43:22 +usersch3.tex
  184.     3537    1332 62.3% 17-Sep-93 20:21:12 +convert68k.el
  185.    25992    7880 69.6% 08-Dec-93 23:33:00 +pari.el
  186.    16577    6269 62.1% 08-Dec-93 23:10:42 +pari.elc
  187.     3710    1621 56.3% 06-Nov-93 11:46:46 +pari.menu
  188.     9737    3698 62.0% 18-Jul-93 13:24:50 +pari.txt
  189.      100      84 16.0% 05-Aug-93 11:33:36 +bench.gp
  190.     2169    1108 48.9% 01-Nov-93 18:30:14 +clareg.gp
  191.     3319    1602 51.7% 01-Nov-93 18:29:14 +EXPLAIN
  192.       52      52  0.0% 05-Aug-93 11:33:16 +lucas.gp
  193.      182     136 25.2% 04-Nov-93 03:53:16 +Makefile
  194.      151     129 14.5% 05-Nov-93 11:52:34 +Makesimple
  195.     1483     805 45.7% 02-May-93 16:06:40 +mattrans.c
  196.      260     149 42.6% 05-Aug-93 11:36:46 +rho.gp
  197.      709     394 44.4% 07-Feb-93 04:24:20 +squfof.gp
  198.     1745     856 50.9% 03-Dec-93 12:16:48 +tutnf.gp
  199.     7956    3048 61.6% 03-Dec-93 12:19:08 +tutnfout
  200.     3265    1495 54.2% 28-Nov-93 18:04:40  Newin1.39
  201.     3086    1615 47.6% 01-Nov-93 18:48:50  README
  202.     6156    2926 52.4% 18-Dec-93 14:51:22  README.amiga
  203.      534     319 40.2% 01-Nov-93 18:45:16  TODO
  204. -------- ------- ----- --------- --------
  205.  2619534 1150462 56.0% 08-Jun-95 10:09:10   31 files
  206.